home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / Vk / VkCmdFactory.z / VkCmdFactory
Encoding:
Text File  |  2001-04-17  |  3.6 KB  |  133 lines
  1.  
  2.  
  3.  
  4. VVVVkkkkCCCCmmmmddddFFFFaaaaccccttttoooorrrryyyy((((3333xxxx))))                                              VVVVkkkkCCCCmmmmddddFFFFaaaaccccttttoooorrrryyyy((((3333xxxx))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      VkCmdFactory - produces VkCmd objects
  10.  
  11. IIIINNNNHHHHEEEERRRRIIIITTTTSSSS FFFFRRRROOOOMMMM
  12.      VkCallbackObject
  13.  
  14. HHHHEEEEAAAADDDDEEEERRRR FFFFIIIILLLLEEEE
  15.      #include <Vk/VkCmdFactory.h>
  16.  
  17. CCCCLLLLAAAASSSSSSSS DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  18.           The VkCmdFactory is an optional class that provides some useful
  19.           services for applications that use VkCmd objects. Although VkCmd
  20.           objects can be executed directly or via a VkCmdManager, the
  21.           VkCmdFactory is useful when commands can be executed from multiple
  22.           sources. For example, some applications might make an operation
  23.           available to the user from a menu bar, a toolbar, a popup menu, and
  24.           perhaps other parts of a user interface. A VkCmdFactory provides a
  25.           central object that multiple interfaces can communicate with to
  26.           launch the same command.
  27.  
  28.           Any VkComponent can register itself with a VkCmFactory object, to
  29.           track the availability of the command. If the VkCmdFactory is
  30.           deactivated, all registered components will be desensitized
  31.           automatically. In addition, any VkComponent, registered or not, can
  32.           register an cmdExecutedCallback member function with A VkCmdFactory
  33.           object. This callback will be invoked when a command is executed by
  34.           the Factory.
  35.  
  36.           A VkCmdFactory object can execute a VkCmd object instantiated by the
  37.           application, but it is most useful in conjuntion with VkCmd objects
  38.           that have registered themselves by name with the VkCmdRegistry. In
  39.           this case, the name given to a VkCmdFactory instance specifies the
  40.           name of the object to be created. Alternately, A VkCmdFactory object
  41.           can be given a function to call to create a VkCmd object when one is
  42.           needed.
  43.  
  44.  
  45.  
  46. CCCCAAAALLLLLLLLBBBBAAAACCCCKKKKSSSS
  47.           This class supports the following callbacks:
  48.  
  49.  
  50.  
  51.               activateStateChangedCallback
  52.               cmdExecutedCallback
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. VVVVkkkkCCCCmmmmddddFFFFaaaaccccttttoooorrrryyyy((((3333xxxx))))                                              VVVVkkkkCCCCmmmmddddFFFFaaaaccccttttoooorrrryyyy((((3333xxxx))))
  71.  
  72.  
  73.  
  74. SAMPLE CODE
  75.      /usr/share/src/ViewKit/Commands/ByName/
  76.      /usr/share/src/ViewKit/Commands/Factories/
  77.      /usr/share/src/ViewKit/Commands/Factory2/
  78.  
  79.  
  80.  
  81. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  82.      VkCmd, VkCmdManager, VkCmdRegistry
  83.      _V_i_e_w_K_i_t _P_r_o_g_r_a_m_m_e_r'_s _G_u_i_d_e
  84.      _T_h_e _X _W_i_n_d_o_w _S_y_s_t_e_m, DEC Press, Bob Sheifler and Jim Gettys
  85.      _T_h_e _X _W_i_n_d_o_w _S_y_s_t_e_m _T_o_o_l_k_i_t, DEC Press, Paul Asente and Ralph Swick
  86.      _T_h_e _O_S_F/_M_o_t_i_f _P_r_o_g_r_a_m_m_e_r_s _R_e_f_e_r_e_n_c_e, Prentice Hall, OSF
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.